home *** CD-ROM | disk | FTP | other *** search
/ Gekikoh Dennoh Club 1 / Gekikoh Dennoh Club Vol. 1 (Japan).7z / Gekikoh Dennoh Club Vol. 1 (Japan) (Track 1).bin / kowin / archive / sys / kowin14d.lzh / doc / programming / kowin_p1.doc < prev    next >
Text File  |  1995-09-15  |  12KB  |  331 lines
  1.  
  2. Ko-Window プログラミング予備知識編
  3.  
  4.  
  5.   ここでは具体的なプログラミングの説明には深入りしません。プログラミングの実
  6. 戦に入る前に、軽くでいいから Ko-Window の全体を見渡しておきたい、という方は
  7. 読んでおいて下さい。
  8.  
  9.  
  10. ●ウィンドウ
  11.  
  12.   ウィンドウとは１つの独立した座標空間です。すべてのウィンドウは HOME 位置を
  13. 原点としたワールド座標を持っており、そのうちビューポートで指定される領域のみ
  14. が四角い範囲を通して見ることができます。
  15.  
  16.  
  17. ●階層ウィンドウ
  18.  
  19.   １つのウィンドウの中に小さなウィンドウをぽこぽこ開くことができます。中に開
  20. いたものを親ウィンドウに対する子ウィンドウといい、このようにいくつでも階層構
  21. 造を持つことができます。子ウィンドウはあくまで親ウィンドウのビューポート空間
  22. の中に存在しているので、決して親ウィンドウの外にはみでることはありません。
  23.  
  24.     +------------------+
  25.     | 親ウィンドウ       |
  26.     |           |
  27.     |    +------+   |
  28.     |    |  子  |   |
  29.     |    +------+   |
  30.     |           |
  31.     +------------------+
  32.  
  33.   １つの親に対して複数の子ウィンドウ(兄弟関係)を開くことができます。この兄弟
  34. ウィンドウ同士は対等の立場ですが、それぞれみな重なりの順番を持っており、上に
  35. なっているものほど優先度が高くなります。
  36.  
  37.  
  38. ●ルートウィンドウ
  39.  
  40.   画面全体のことをルートウィンドウといいます。つまり DISPLAY画面は１つの大き
  41. なウィンドウであり、プログラムがその中に開くアプリケーションウィンドウは全部
  42. ルートウィンドウの子に相当します。
  43.  
  44.   多くのアプリケーションはさほどウィンドウに階層を持たずに、ルートの子供とし
  45. て１つだけウィンドウを開きそれで完結しています。これが最も単純なアプリケーショ
  46. ンの形です。
  47.  
  48.  
  49. ●ウィンドウを開くには
  50.  
  51.   WindowOpen() 関数を呼び出します。ただし、これにはバリエーションがあり、以
  52. 下のように用途によって使い分けます。
  53.  
  54.     WindowOpen()        何も飾りもつかず、純粋にウィンドウのみ開きま
  55.                 す。実用上は直接これを呼び出したり直接ルート
  56.                 の下に開くことは少ないでしょう。
  57.  
  58.     WindowSimpleOpen()    浮き上がったようにウィンドウ枠がつきます。タ
  59.                 イトルバーのないウィンドウはほぼ間違いなくこ
  60.                 の関数で開かれています。
  61.  
  62.     WindowTitleOpen()    もっとも標準的なアプリケーションウィンドウで
  63.                 す。SimpleOpen() 同様の枠に加え、タイトルバー
  64.                 がつきます。
  65.  
  66.     WindowScrollOpen()    スクロールバーつきのウィンドウを開きます。ただ
  67.                 し枠もタイトルバーもありません。普通は
  68.                 WindowSimpleOpen() や WindowTitleOpen() の中
  69.                 に子ウィンドウとして開き、任意の場所をスクロー
  70.                 ルさせるのに使います。 Command.win や view.win
  71.                 では WindowTitleOpen() の中に子ウィンドウとし
  72.                 てぴったり合うように開かれています。
  73.  
  74.   Ko-Window では、ウィンドウを開くための関数はこの４つしかありません。これら
  75. 全部の関数に共通するパラメータは、親に対するドット座標、ドットサイズ、そして
  76. 親ウィンドウのID指定とイベント実行関数です。
  77.  
  78.  
  79. ●イベントとは
  80.  
  81.   Ko-Window のプログラムはすべて受け身です。１つのウィンドウプログラムに対し
  82. て、ユーザーの操作が行われたと判断した時点ではじめて、サーバーがウィンドウの
  83. 指定ルーチンを呼び出します。例えば、マウスが押された、キーが押された、画面を
  84. 書き直さなければならなくなった、等。これらの、起点となるユーザー操作について
  85. の情報がウィンドウに送られてくることを総称してイベントと呼びます。
  86.  
  87.   これは割り込みルーチンを予め用意しておいて、外部要因で割り込みが発生した時
  88. に必要に応じてそれぞれのルーチンが実行される場合によく似ています。イベントと
  89. いう言葉を「割り込み」に置き換えて読み進むと(一部の方には)分かりやすいかもし
  90. れません。
  91.  
  92.  
  93. ●イベントドリブンのイメージ
  94.  
  95.   ウィンドウはすべて、開く時にそのウィンドウの処理を行うイベント関数を登録し
  96. ます。例えば (A)ウィンドウの上でマウスの左ボタンが押されたら、サーバーは (A)
  97. ウィンドウに登録された「マウスの左ボタンが押された時のイベント処理ルーチン」
  98. を実行します。
  99.  
  100.     +-------------------------------+
  101.     | ルートウィンドウ        | (A)ウィンドウのイベント処理ルーチン
  102.     |                |     もしマウス左ボタンが押されたら
  103.     | +------+            |        ○○の処理をする
  104.     | | (A)  |            |     もしキーが押されたら
  105.     | +------+    +------------+    |        ○○の処理をする
  106.     |        |         |    |         :
  107.     |        |    (B)     |    |
  108.     |        |         |    | (B)ウィンドウのイベント処理ルーチン
  109.     |        +------------+    |     もしウィンドウ位置を変更したら
  110.     +-------------------------------+        ○○の処理をする
  111.  
  112.   ウィンドウは１つのオブジェクトであり、イベントはそれに対するメッセージであ
  113. るともいえるでしょう。
  114.  
  115.  
  116. ●イベント関数で記述可能なもの
  117.  
  118.   送られてくる可能性のあるイベントは以下の表にまとめた通りです。実際はこの中
  119. から、アプリケーションが必要とする部分だけプログラムを書いて登録します。
  120.  
  121.   例えばキー入力を使わないプログラムなら EventKey の処理ルーチンを書く必要は
  122. ありません。そのウィンドウが必要とするイベントと必要としないイベントを、
  123.  WindowSetEventAttr() 関数で設定することができます。いわゆるイベントマスクで
  124. す。この欲しいイベントを定義することを、そのウィンドウが○○のイベントを獲得
  125. する、と表現することがあります。
  126.  
  127.  
  128. ≪基本イベント≫
  129.  
  130.   ウィンドウプログラムは、最低限以下の３つのイベントに対する処理ルーチンを持っ
  131. ています。(ものによっては無くても構いませんがここでは触れません)
  132.  
  133. EventOpen    ウィンドウを開く時一度だけ発生します。ここでウィンドウの初期
  134.         化を行っておくことができます。
  135.  
  136. EventClose    EventOpen の逆で、ウィンドウを閉じる時に発生します。後始末は
  137.         ここで行います。
  138.  
  139. EventRedraw    画面を書き直す時に発生します。このイベントでウィンドウ内のす
  140.         べての表示が再描画可能でなければなりません。
  141.  
  142.  
  143. ≪ユーザーオペレーションイベント≫
  144.  
  145.   ユーザーの直接の操作に対するイベントです。プログラムがユーザーとの対話を行
  146. うにはこれらのイベントのうち必要なものを獲得するよう処理ルーチンを書いておく
  147. 必要があるでしょう。
  148.  
  149. EventMouseSwitch  マウスのボタンが押された(または離された)時に発生します。
  150.  
  151. EventMouseMove    マウスカーソルの移動が行われた時に発生します。
  152.  
  153. EventMouseEnter    マウスカーソルがウィンドウに入った時に発生します。ウィンドウ
  154.         がフォーカスされたときのアクションを記述します。(Ko-Window で
  155.         はさほど重要視されていない)
  156.  
  157. EventMouseOut    EventMouseEnter の反対にマウスカーソルがウィンドウから出た時
  158.         に発生します。
  159.  
  160. EventKey    キー入力が行われた時に発生します。
  161.  
  162.  
  163. ≪ウィンドウオペレーションイベント≫
  164.  
  165.   これらは特に処理ルーチンを用意しなくても、デフォルトでそれなりの動作をして
  166. くれます。この操作が行われた時に特別な処理が必要だ、という場合に処理ルーチン
  167. を定義するために使います。(アセンブラのベクタテーブルを書き換える的な意味合
  168. いでしょう)
  169.  
  170. EventPop    ウィンドウを１番上にする操作が行われた時に発生します。
  171.  
  172. EventPush    ウィンドウを１番下にする操作が行われた時に発生します。
  173.  
  174. EventMove    ウィンドウを移動する時に発生します。
  175.  
  176. EventResize    ウィンドウの大きさを変更する時に発生します。
  177.  
  178. EventScroll    ウィンドウ内部をスクロールする動作が行われた時に発生します。
  179.  
  180.  
  181. ≪タイトルバースイッチイベント≫
  182.  
  183.   これらはタイトルバーつきウィンドウで、それぞれのスイッチがクリックされた時
  184. に発生します。イベントは発生しても、それがどういうアクションを起こすかはユー
  185. ザー任せです。オペレーションイベントとは異なり、処理ルーチンを定義しなければ
  186. 何もしません。
  187.  
  188. EventIconify    アイコン化ボックスがクリックされた時に発生します。
  189.  
  190. EventZoom    ズームボックスがクリックされた時に発生します。
  191.  
  192.  
  193. ≪その他のイベント≫
  194.  
  195. EventInterval    他に何のイベントも発生していない時は、常にこのイベントが発生
  196.         します。ユーザー操作を起点としない唯一のイベントで、時計プロ
  197.         グラムやリアルタイムに動いているように見えるプログラムは全部
  198.         このイベントによって駆動されています。
  199.  
  200. EventUser    ユーザーがプログラム間で自由に動作を定義できるイベントです。
  201.         アプリケーションのウィンドウ操作に依存しない外部コントロール
  202.         や、Clip Board 等のウィンドウ間通信はこれで実現されています。
  203.         (利用方法については user.doc や UserGraphic.doc 参照)
  204.  
  205. EventGraphic    他のイベントと一線を画すもので、サーバーの状態変換を知らせる
  206.         ために発生します。具体的にはグラフィックモードが変化した時に
  207.         起こり、グラフィック画面の色数に依存したプログラムが共存でき
  208.         るよう協調をはかります。
  209.  
  210.  
  211. ●プロセスとウィンドウの違い
  212.  
  213.   今まで説明文中に「ウィンドウ」、「アプリケーション」等の言葉が混在していま
  214. したがここでその区別をある程度説明しておきます。
  215.  
  216. プロセス:    Ko-Window 上で起動されるプログラムの単位です。１つのプロセス
  217.         は必要に応じてウィンドウを何個でも開くことができます。しばし
  218.         ばアプリケーションはこのプロセスと同じ１つのプログラム単位の
  219.         意味で使われます。
  220.  
  221.         プロセスに対する外部からのリクエストを Signal といいます。ほ
  222.         とんどの場合、SignalKill をプロセスに送ると、そのプロセスの開
  223.         いているすべてのウィンドウを閉じ、終了します。
  224.  
  225.         プロセスがいくつ動いているかは Command.win の ps コマンドで確
  226.         認できます。現在の Ko-Window では最大プロセス数は 32 です。
  227.         (この限界値は単純にテーブルの個数なので、サーバーの再コンパ
  228.         イルにて変更可能)
  229.  
  230.  
  231. ウィンドウ:    画面上に現れるオブジェクトの単位です。ウィンドウは必ず対とな
  232.         るイベント処理関数を1つ持っています。ただし複数のウィンドウ
  233.         が１つのイベント処理関数を共有している場合もあります。
  234.  
  235.         ウィンドウに対する外部からのリクエストを Event といいます。
  236.         EventClose が即プロセスの終了にはつながりませんが、ウィンドウ
  237.         を１つしか開かないアプリケーションではたいてい EventClose 時
  238.         にプロセス終了になるよう記述されています。(ConnectionClose())
  239.  
  240.         プロセスとは違い階層構造をもち、ウィンドウの開ける数は、サー
  241.         バーの割り当てるメモリの限界までです。プロセスのような固定値
  242.         の限界があるわけではありません。
  243.  
  244. 注: ここでいうプロセスとは、Human68k でいうプロセスとは別ものです。Ko-Window
  245.     自体が Human68K のプロセスの1つとして動作します。その内部に Ko-Window 独
  246.     自のプロセス管理が存在します。また Ko-Window 上で BG 機能を使ったりすると
  247.     また別のプロセス、という言葉が出てくる場合があります。
  248.     この辺の関係は、process.doc で説明します。
  249.  
  250.  
  251.  
  252. ●ウィンドウの座標系
  253.  
  254.   ウィンドウは目に見えるものです。もちろん、敢えて見えないように設定する場合
  255. もありますが、常に利用者に対する視覚的目的のために使われます。そのウィンドウ
  256. 内の表示は操作の指示としてドット位置による座標が用いられます。
  257.  
  258.   これは HOME 位置を原点にし、左上をマイナス方向、右下をプラス方向で表し、そ
  259. れぞれのウィンドウが独自の座標系を持っています。これをウィンドウのローカル座
  260. 標と呼びます。
  261.  
  262.   HOME 位置は WindowSetHome() 関数で変更可能なので、例えば HOME 位置を変更し
  263. てウィンドウの再描画を行えばウィンドウ内をスクロールさせることができます。
  264.  
  265.   親ウィンドウからイベントが子ウィンドウに伝搬する場合、例えばマウスのクリッ
  266. ク位置等はそれぞれのウィンドウのローカル座標に変換されます。だからアプリケー
  267. ション側ではウィンドウが画面のどこにあるかに惑わされることなく、自分の世界だ
  268. けの処理に徹すれば良いことになります。
  269.  
  270.  
  271. ●フォーカスウィンドウ
  272.  
  273.   フォーカスウィンドウというのは現在ユーザーが操作対象にして注目しているウィ
  274. ンドウのことです。例えばキーボードは１つしかありませんから、打ったキーがどの
  275. ウィンドウに送られればいいのかわかりません。
  276.  
  277.   そこで現在注目しているウィンドウを１つに決め、キー操作はそこに送られるよう
  278. にします。Ko-Window ではこれはマウスカーソルが載っているウィンドウを意味しま
  279. す。よって、必ずしもフォーカスウィンドウが重なりの１番上になっているわけでも、
  280. 何か処理に特別扱いされているわけでもありません。
  281.  
  282.   特に１つのウィンドウをフォーカスウィンドウとして認識させるには、関数
  283.  WindowSetFocus() を使います。この場合マウスカーソル位置と無関係に、キー入力
  284. が常に指定したウィンドウに送られます。
  285.  
  286.  
  287.  
  288. ●ウィンドウ内描画コマンド
  289.  
  290.   サーバーによる描画は最小限のものに限られています。
  291.  
  292.   DrawSetClear()    ウィンドウ内を指定色で塗り潰します
  293.  
  294.   DrawSetSymbol()    文字列を指定位置に指定色の指定の大きさで描きます
  295.  
  296.   DrawSetLine()        線や函を描きます。塗り潰しや浮き沈みの指定ができます
  297.  
  298.   DrawSetPut()        Sheet 型のグラフィックパターンを任意の位置に描きます
  299.  
  300.   DrawSetPattern()    Sheet 型のパターンを繰り返して中を埋めます
  301.  
  302.   DrawSetCircle()    円を描きます (WSRV.X 2.24+10以降のみ)
  303.  
  304.   DrawSetDot()        点を打ちます (WSRV.X 2.24+10以降のみ)
  305.  
  306.   DrawSetGraphicClear()    グラフィック画面を塗り潰します
  307.  
  308.   DrawSetGraphicLine()    グラフィック画面に線やはこを描きます
  309.  
  310.   DrawSetGraphicPut()    グラフィックパターンの転送をします
  311.  
  312.   DrawSetGraphicCircle()  グラフィックに円を描きます (WSRV.X v2.24+10以降のみ)
  313.  
  314.   DrawSetGraphicDot()    グラフィックに点を打ちます (WSRV.X v2.24+10以降のみ)
  315.  
  316.  
  317.   ウィンドウ描画のメモリ上のイメージとして Sheet 型のバッファを持つことができ
  318. ます。この上では上記の同様の描画が Sheet 関数によってできます。(注：これはサー
  319. バーではなくライブラリが行います)
  320.  
  321.  
  322. ----
  323. 1994  8/22 初期公開版
  324. 1994 12/19 若干の修正
  325. 1995  9/15 誤字および一部表現の修正
  326.  
  327. 小笠原博之
  328. oga@dgw.yz.yamagata-u.ac.jp
  329. DenDenNET: DEN0006 COR.
  330.  
  331.